home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / boot tools / syspic / syspic.doc < prev    next >
Text File  |  1996-04-07  |  10KB  |  319 lines
  1.  
  2.              --------------------------------------------------
  3.  
  4.                              »»» SysPic v2.02 «««
  5.                           "Make your boot look cute!"
  6.  
  7.                        Cardware © 1995 The Beet Research
  8.  
  9.                          written by Grzegorz Calkowski
  10.  
  11.       -----------------------------------------------------------------
  12.  
  13.  
  14. Disclaimer
  15. ----------
  16.  
  17.     The program executable and information above is provided "as is".  No
  18. representations or warranties are made with respect to the accuracy,
  19. reliability, performance, currentness, or operation of this software and
  20. information, and all use is at your own risk.  The author doesn't assume any
  21. responsibility or liability whatsoever with respect to your use of the program
  22. and information.
  23.  
  24.  
  25. Copying
  26. -------
  27.  
  28.     SysPic is now CardWare (no longer, hmhm, BeetWare...).  This means your are
  29. *OBLIGED* to send me a postcard if you use it regulary.  (BTW:  if you use
  30. SysPic, it's probably the most frequently used proggie, isn't it?) Treat the
  31. card as a shareware fee.
  32.  
  33. This program can be freely distributed under following conditions:
  34.  
  35.         1. Everything in this distribution must be kept together and
  36.            unaltered. Applies to:
  37.  
  38.            C/SysPic                     (the program itself)
  39.            C/SysPic.020                 (68020+ version)
  40.            C.info
  41.            SysPic.doc                   (plain ASCII doc)
  42.            SysPic.doc.info
  43.            SysPic.guide                 (AmigaGuide®'d doc)
  44.            SysPic.guide.info
  45.            WBStartup/ClosePic           (command removing the picture)
  46.            WBStartup/ClosePic.info      (its icon - MWB style)
  47.            WBStartup.info
  48.  
  49.         2. Copyright notices are not removed from executable and
  50.            documentation.
  51.  
  52.         3. No more than a nominal fee is charged to cover cost of magnetic
  53.            media.
  54.  
  55. SysPic is Copyright (C) 1995 The Beet Research. All rights reserved.
  56.  
  57.  
  58. Introduction
  59. ------------
  60.  
  61.     If you think that black screen during boot time is boring and you want make
  62. the boot look more professional (or even fancy) it is definitely program for
  63. you. I know there are other similar programs - but SysPic's features make it
  64. absolutely the BEST!
  65.  
  66.     SysPic is a small viewer-like program meant to show a picture during the
  67. boot time.  The picture can be removed at any time using an independent command
  68. (ClosePic) which can be placed for example in your WBStartup drawer.
  69.  
  70.     Features - SysPic
  71.  
  72.       o is small & fast
  73.  
  74.       o shows IFF-ILBM pictures of any size and resolution
  75.  
  76.       o supports AGA modes (also HAM8)
  77.  
  78.       o forces Workbench to open behind the displayed picture so it can be
  79.         closed after whole Workbench initialization
  80.  
  81.       o blanks the pointer sprite so you won't see it when the Workbench
  82.         screen activates (it would look annoying) (see Bugs)
  83.  
  84.       o has a nice random number generator
  85.  
  86.       o detaches from shell in an intelligent way (i.e after loading
  87.         the picture)
  88.  
  89.       o !!!COOL-> sets overscan prefs before IPrefs will do it. <-COOL!!!
  90.  
  91.       o supports BeetLogin (closes it's 'fake' screen)
  92.  
  93.       o is 100% legal
  94.  
  95.       o has been tested with Enforcer, Mungwall & MemWatch
  96.  
  97.  
  98. Requirements
  99. ------------
  100.  
  101.     SysPic requires at least Kickstart 3.0 (sorry, I promised to make it 2.04
  102. compatible...  but not this time yet).  It makes not much sense to use it
  103. without harddisk.  Memory requirement depends on size and no.  of colours of
  104. displayed picture.
  105.  
  106.     SysPic uses iffparse.library which should be installed in your LIBS:.
  107. The library comes with your Workbench package.
  108.  
  109.  
  110. Installation
  111. ------------
  112.  
  113.     It's fairly easy.  First copy file 'SysPic' whereever you want.  I
  114. recommend you to put it to C:  or somewhere else on your command path.  Then
  115. add to your 'startup-sequence' following line:
  116.  
  117.         SysPic <picture> <options>
  118.  
  119.     As of version 2.00 SysPic sets the overscan prefs so you can put it right
  120. after SetPatch (recommended).
  121.  
  122.     In order to remove opened picture, the small program 'ClosePic' is needed.
  123. Simply drop it to 'WBStartup' drawer, which is the best suitable place for it.
  124. To have picture closed when whole Workbench is initialized set STARTPRI
  125. tooltype to -128.  It assures that 'ClosePic' will be launched last (for your
  126. convinience it is already set to -128 :).
  127.  
  128.     If you don't put it to 'WBStartup' drawer you have to add following line at
  129. the end of 'startup-sequence':
  130.  
  131.         ClosePic
  132.  
  133.     Note, that there is 68020+ version supplied.  If you have 68020, 68030,
  134. 68040, or maybe 68060 based Amiga you should use it instead.
  135.  
  136.  
  137. Usage
  138. -----
  139.  
  140.     The main program - 'SysPic' can be used only from Shell.  It makes not much
  141. sense to use it from Workbench (for what ?).  Therefore don't try to launch it
  142. from WB because it will do nothing (at least it won't crash the machine).
  143.  
  144.     The options template for 'SysPic' looks like:
  145.  
  146.     PICTURE/A,RANDMIN/N,RANDMAX/N,DIGITS/N,BF=BESTFIT/S,SO=SETOSCN/S
  147.  
  148.     where
  149.  
  150.         PICTURE <path>          Specifies the filepath for an IFF-ILBM picture.
  151.                                 Note, that PICTURE keyword can be omitted.
  152.  
  153.                 If you specify an asterisk (*) in the name it
  154.                 will be replaced with randomly generated
  155.                 number. In such case you have to specify both
  156.                 RANDMIN and RANDMAX.
  157.  
  158.     RANDMIN <number>    Lower bound for random generator
  159.  
  160.     RANDMAX <number>    Upper bound for random generator
  161.  
  162.     DIGITS <size>        Specifies how many digits will be inserted.
  163.                 If length of generated number is shorter than
  164.                 specified size it will be filled with leading
  165.                 zeros.
  166.  
  167.         BF or BESTFIT           Switch - if specfied program will use
  168.                                 BestModeIDA() function of Kickstart 3.0+
  169.                                 to get the best resolution for the picture.
  170.  
  171.                                 It sometimes can give unexpected results.
  172.                                 Generally it's better to save the picture in
  173.                 desired viewmode.
  174.  
  175.     SO or SETOSCN        Sets your overscan preferences (from
  176.                 envarc:sys/overscan.prefs file). It avoids
  177.                 the very annoying screen-jump when IPrefs sets
  178.                 the overscan prefs. It's very usable when you
  179.                 want to display a picture in a multisync mode
  180.                 like DBLPAL or MULTISCAN, which overscan
  181.                 preferences usually differ from the defaults.
  182.                 Note, it's a hack! See Bugs.
  183.                 
  184.  
  185.     The 'ClosePic' can be used from Workbench as well what is recommended.
  186. Simply put it into 'WBStartup' drawer and forget about it.  See Instalation.
  187.  
  188.     Well, in fact, SysPic is full-featured viewer.  It can display any ILBM
  189. image upto 256 colours and HAM6/HAM8 images as well.  IFF parsing routines are
  190. based on orginal C= routines.
  191.  
  192.  
  193. To Do
  194. -----
  195.  
  196.     No ideas. I think the proggie is complete.
  197.     But if you have some suggestions...?
  198.  
  199.  
  200. Bugs
  201. ----
  202.  
  203.     Sprite blanking is still not perfect.  Why?  Normally it's no problem to
  204. get rid of sprites - it can be done by disabling sprite DMA or just by setting
  205. a window's mouse pointer to an invisible one.  It works fine :-).  But no if an
  206. another program is poking in sprite stuff in the background.  And this is the
  207. case, because IPrefs does so (it changes display params with VideoControl(),
  208. namely).  The only thing I could do was an interrupt server, which was turning
  209. off sprite DMA subsequently.  I have no other ideas!  If you know a better one
  210. _please_ contact me!!
  211.  
  212.     Another thing, not really a bug - overscan prefs.  Starting from Release 2
  213. there are no documented methods for setting preferences.  The only program in
  214. universe able to do it is IPrefs.  Well, everything can be done :-) SysPic sets
  215. the overscan prefs EXACTLY in the same way as IPrefs does.  But this can be
  216. considered as kind of hack.  Well, works fine under V39 & V40, however, this
  217. maybe not be the case under future releases of Kickstart.
  218.  
  219.  
  220. Contacting the author
  221. ---------------------
  222.  
  223.     Any ideas, bug reports, donations, hardware (for example Cyberstorm
  224. turboboard for my A4000), etc.  will be sincerely welcomed.  Just contact me!
  225.  
  226.     My addy:
  227.                 Grzegorz Calkowski
  228.                 Rzedowice
  229.                 ul.Dobrodzienska 8
  230.                 42-780 Dobrodzien
  231.                 POLAND
  232.  
  233.     Phone:      +48(0)34-575875
  234.  
  235.     E-mail:    calkowsk@us.edu.pl
  236.  
  237. (Sorry, for my poor English...)
  238.  
  239.  
  240. Always remember:
  241. ----------------
  242.  
  243.         Beeting is beliving...
  244.  
  245.         and Amiga is the best computer ever!
  246.  
  247.  
  248. Acknowledgements
  249. ----------------
  250.  
  251. Thanks go to:
  252.  
  253.    o  Michal Prochownik for general support & for the game idea
  254.       (We WILL make it!)
  255.  
  256.    o  Ryszard "Justus" Baginski for ClosePic's icon.
  257.  
  258.    o  Jacek "Plexa" Miklasiewicz for the job...
  259.  
  260.    o  Jacek "Shind" Grzegorczyk for the 340MB HDD (really nice gift 8-)
  261.  
  262.    o  For develop team at C= (R.I.P) for the wonderful machine.
  263.  
  264.    o  ESCom for Amiga Technologies.
  265.    
  266.  
  267.  
  268. History
  269. -------
  270.  
  271. v1.00ß (22.07.95)
  272.  
  273.     o First BETA release.
  274.  
  275.  
  276. v1.50 (25.08.95)
  277.  
  278.     o not "historized" and not released
  279.  
  280.  
  281. v2.00 (30.08.95)
  282.  
  283.     ** not released to public
  284.  
  285.     o Now SysPic automatically detaches from current Shell process. It does it
  286.       in intelligent way, i.e exits after the picture is loaded & displayed.
  287.  
  288.     o Added random generator. New options: RANDMIN, RANDMAX, DIGITS.
  289.  
  290.     o Added feature of setting overscan prefs before IPrefs will do that!
  291.       (New option: SETOSCN). It's a hack! See Bugs.
  292.  
  293.     o Sprite blanking works better but it is still unreliable.
  294.  
  295.     o Added shortcut for BESTFIT - BF.
  296.  
  297.  
  298. v2.01 (05.09.95)
  299.  
  300.     ** not released to public
  301.  
  302.     o Improved sprite blanking. A little, in fact :-). See Bugs.
  303.  
  304.  
  305. v2.02 (27.09.95)
  306.  
  307.     o Added support for my other utility - BeetLogin. Automatically closes
  308.       'fake' screen leftover by it.
  309.  
  310.     o In some cases SysPic didn't display error messages (ie "Not IFF file").
  311.       Fixed.
  312.  
  313.     o Rendezvous port priority set to a high value to improve ClosePic's
  314.       performance.
  315.  
  316.     o Documentation updated.
  317.  
  318.     o Finally released... (and probably the final release... :-)
  319.